.\" SPDX-License-Identifier: CC-BY-SA-4.0 or-later
.\" SPDX-FileCopyrightText: 2022 grommunio GmbH
.TH kdb\-uidextract\-limited 8 "" "Gromox" "Gromox admin reference"
.SH Name
\fBkdb\-uidextract\-limited\fP \(em Helper for creating a gromox\-kdb2mt ACL map
.SH Synopsis
\fBperl /usr/libexec/gromox/kdb\-uidextract\-limited\fP
.SH Description
kdb\-uidextract\-limited is a Perl script utilizing just the Kopano command
line interface of the kopano\-admin(8) and kopano\-stats(8) programs to read
user object descriptions off a Kopano installation and produce an ACL map for
use with the gromox\-kdb2mt \-\-user\-map option.
.PP
This script is meant to be executed on a Kopano system and does not rely on
Gromox at all.
.PP
Unlike kdb\-uidextract, kdb\-uidextract\-limited also does not rely on the
presence of python\-kopano bindings (e.g. for when installing those is
considered infeasible). However, kdb\-uidextract\-limited can only evaluate the
host it is executed on and has no automatic multi-server capability. This is
because kopano\-stats(8) never loads a TLS certificate needed to make the \-h
option work. To produce a complete map, you need to manually execute
kdb\-uidextract\-limited on all Kopano server instances in a cluster and then
join the results in accordance with the JSON syntax, e.g. by use of jq(1).
.PP
kopano\-server need not be set up for TLS.
.PP
The resulting map for kdb2mt is printed to stdout.
.SH Options
This program offers no command-line options.
.SH See also
\fBgromox\fP(7), \fBgromox\-kdb2mt\fP(8), \fBkdb\-uidextract\fP(8)
